home *** CD-ROM | disk | FTP | other *** search
/ EuroCD 3 / EuroCD 3.iso / Communication / Citadel_BBS / Exec / read.me < prev    next >
Encoding:
Text File  |  1998-06-24  |  17.4 KB  |  345 lines
  1.  Note:  8A01
  2.  
  3.  Note:  For this release, you must delete the CTDLTABL.SYS file and
  4.         run CONFG to be able to use this update.
  5.  
  6.  See the UPDATE.TXT file for additional changes, bug fixes, ect...
  7.  
  8.  
  9.  *AFTER* 3.42.Q16, I changed the version identification to make it simpler
  10.  and to eliminate some of the confusion as to what version Citadel 68K is
  11.  closer to(Citadel 86 version 3.42 was the original base, 3.48 updates were
  12.  applied).
  13.  
  14.   The version id is  YMDD
  15.                      || |_______ day of the month
  16.                      ||__________Letter representing the month (A-Jan, L-Dec)
  17.                      |___________Last digit of the year
  18.  
  19.  
  20.  Suggested install Instruction of this version of Citadel;
  21.  
  22.    1) cit_messages.sys
  23.  
  24.      This file contains the messages used by Citadel.  about 90% of the
  25.      messages are in this file.  You can customize the messages.  The
  26.      file included has cit:helps as the location of several help files
  27.      so check to see that everything is correct for your system.
  28.      The messages with an "@" are references to files that must be on
  29.      your system(they should be included here or in the helps).
  30.  
  31.      This file goes in the #MSGAREA directory.  The file format is
  32.      included as comments in this file.  All the extra files in the
  33.      archive named *.MSG also go in this area.  On my BBS, the area
  34.      is called "CIT:GENERAL/", this directory contains these files.
  35.  
  36.      This means you will find references to:
  37.  
  38.       "@cit:general/filename"
  39.  
  40.      You must customize your BBS message file or define CIT:GENERAL
  41.      and put the files there.
  42.  
  43.      If you are updating from a previous version, there is a file
  44.      called MESSAGE.UPDATES that you need to look at to see the changes
  45.      that were made from the .Q02 version.
  46.  
  47.    2) BADNAMES.SYS and BADPASSWORDS.SYS are files that are checked when a
  48.       user is creating their account.  You may use the files included in
  49.       the archive or make your own.  If you do not put these files in
  50.       the room area, Citadel will not check User names and Password
  51.       for validity except to make sure the password is at leas 5 chars
  52.       long and not a duplicate of someone elses.  These work the same
  53.       way BADWORDS.SYS does.  Also is the BADPEOPLE.SYS capability.  This
  54.       file also goes in the ROOMAREA and is used to supress messages from
  55.       any particular user, in any particular room, or from any particular
  56.       system.  There are three field, one line per entry.  You do not need
  57.       this file, it is optional.  It kills any message that matches the
  58.       room, name, and system specified.  A "*" can be used for all.  You
  59.       could for example supress all message from a particular user in a
  60.       room, from any system, if the user is TOM, the ROOM COMPUTER, you
  61.       could have:
  62.  
  63.       TOM SMITH,COMPUTER,*
  64.  
  65.       The fields are separated by commas.  An entry of "*,*,*" is illegal
  66.       and will generate an error(after all why net at all if your going
  67.       to kill all message).  If TOM SMITH is a real pain and you want to
  68.       suppress all messages in all rooms, change "COMPUTER" to "*" to get
  69.       an entry like:
  70.  
  71.       TOM SMITH,*,*
  72.  
  73.       This will only affect networked messages you recieve!  Any messages
  74.       entered on your system will be accepted normally.
  75.  
  76.       Note:  This is pure censorship, it deletes the messages totally and
  77.       no other system `downstream' network wise will see the messages or
  78.       even have the option to see them, they are deleted from your system.
  79.       To supress them on only your system turned out to be too much of a
  80.       problem in the software, live with it... I do not recommend using it
  81.       although, a certain user that was a real pain from a local system
  82.       did have this invoked(a test, but he deserved it...)  At one point,
  83.       some systems were fighting in a room, several people were involved
  84.       and you could have an entry like:
  85.  
  86.        *,BBS LIST,BAD GUYS BBS
  87.  
  88.       That would censor all their messages, no matter what the content.
  89.       I came very close to doing this at one point...  This is an option,
  90.       use it only as a last resort... If the messages really are not a
  91.       problem, ignore them, don't censor them...
  92.  
  93.    3) The VORTEX checking is on by default.  If you do not wish it, you
  94.       must use the "-vortex" option on the command line.  If you have the
  95.       "+vortex" it will have no effect.
  96.  
  97.    4) +netlog and +netdebug are now more effective and if you do not
  98.       specify either one, Citadel will be very silent during a net session.
  99.       +netdebug messages will give alot more detail and if you want
  100.       +netdebug, you should also specify +netlog.  Note: not specifying
  101.       at least +netlog will result in some messages appearing in debug.sys
  102.       by default.  This will change in later versions.
  103.  
  104.       In addition, +CID or +RESULTS on the command line will allow you
  105.       to record the text send from the modem during the baud rate recognition.
  106.       The +CID will record after the first RING is seen, the +RESULTS will
  107.       record all text lines.  The idea of these options is to collect
  108.       caller id info(+CID) and for debuging all modem text(+RESULTS).
  109.       The information will go into the auditarea in debug.sys.
  110.  
  111.    5) parameters for QWK parameters:
  112.  
  113.    #QWKWORKAREA  "<directory>"
  114.      Work directory for temporary files.
  115.    #QWKFILEAREA  "<directory>"
  116.      Where all user data files are saved.
  117.    #QWKMAXROOM     <number>
  118.      This parameter defines the maximum rooms that will be scanned for
  119.      messages for a single packet.  If you set this to say 100 and have
  120.      200 rooms, then a user can only collect 100 rooms with messages at
  121.      a time.  This sets the maximum, users can set a lower number if they
  122.      desired.
  123.    #QWKMAXPACKET  10000
  124.      This parameter defines the manimum number of messages that can be
  125.      collected at one time.  The user can set a smaller limit if desired.
  126.    #QWKNAME      "STRING"
  127.      This parameter defines the name of the QWK packet.  In this example,
  128.      the downloaded packet would be called "STRING.QWK".
  129.    #QWKLOCATION  "MEDFORD, NJ"
  130.      This parameter defines the location of the BBS(displayed by the
  131.      QWK reader).
  132.    6) parameter for biography
  133.  
  134.    #BIOAREA "<directory>"
  135.  
  136.      This specifies the directory you wish to use for the Biographies
  137.      that users enter.  The default will be the home area so it is a
  138.      good idea to specify" #BIOAREA "bio"  to get the current default.
  139.  
  140.    7) Vortex checking.  Citadel automatically checks for vortexed networked
  141.       messages.  It will reject any message originating on your BBS(if it
  142.       returns in a net session), or any message it has already seen.  There
  143.       were improvements in this checking and you will need to go into the
  144.       #NETAREA and delete all the *.vex and, v*.sys files.  Citadel will
  145.       create a sub-directory called vortex and put all its files there.
  146.       there will be a slight increase in disk usage.  To eliminate this
  147.       checking, specify -vortex on the command line.
  148.  
  149.       There is a new structure for the vortex files, each room gets a
  150.       file in the #NETAREA vortex directory.  Delete all the files in
  151.       this area to use this version.
  152.  
  153.     8) There is extensive support for email networking.  To make use
  154.        of this feature, you must grab the archive
  155.        Citadel_Email_Networking.lha
  156.  
  157.  
  158.  ***Legal-ease***
  159.  
  160.  Citadel 68K and Amiga Citadel are trademarks of this Citadel BBS program
  161.  and may not be used for other variants.  This software is FREEWARE and
  162.  may not be distributed on any system that claims a copyright.  If you have
  163.  specific questions about the use and rights to this software, contact me
  164.  on The Amiga Zone (609) 953-8159.  ***This product is not for resale***.
  165.  You may not include Citadel or Citadel related files in any collection
  166.  sold for a profit without my express written permission.  Source for the
  167.  Amiga Citadel is 100% public domain and available for downloading.
  168.  If someone sold you a copy of this program, please let me know, it is not
  169.  for sale.  The only exception is the Aminet and Fred Fish CD collections.
  170.  Those collections may re-distribute this program and the related utilities.
  171.  No commercial collection may distribute this program nor may any system
  172.  attempt to copyright these works just because someone uploaded it to that
  173.  system.  If other software collections would like to include Citadel 68K
  174.  distributions, please contact me, My only wish is that the very latest is
  175.  what is distributed.  Internet news groups like Alt.source, comp.amiga.source
  176.  and anything similar also have permission to post these archives.
  177.  
  178.  There are utilities, See the archive listing.
  179.  
  180.  If you are starting from scratch and have never run a Citadel before.  You
  181.  need to grab the support and help files.  These files are on the C86 Test
  182.  system and the Amiga Zone.  Please download them from there.  Start with the
  183.  latest version of Citadel 68K.  Read the 68K.man file.  In the very near
  184.  future there will be a full AmigaGuide set of documentation along with a
  185.  re-organized Citadel 68K manual.  Until then, read the existing docs.
  186.  The AmigaGuide version of the docs(partially done) is available for you
  187.  to download.  Look in the Citadel Documentation room on my BBS or D342.lha
  188.  if your looking at a CD collection like Aminet CDs.
  189.  
  190.  If you are interested in doors, The Amiga Zone has several that will run
  191.  with Citadel 68K.  Any CLI based program will be able to run as a door
  192.  so long as it uses only standard I/O(i.e. getchar(), printf, ect.).
  193.  Doors are available in the Citadel Doors room.
  194.  
  195.  If you have a bug to report, Please use the Citadel 68K room and prefix the
  196.  report with:
  197.  
  198.   ***bug report*** Version 8A01
  199.  
  200.   Please include your phone number of your BBS.  I may want to call to chat.
  201.   or pick up a file or two to reproduce your bug.  A list of Citadels is at
  202.   the end of this file, there are probably more than those listed, but I
  203.   collect this information from the vortex detector and these are active
  204.   Citadels.
  205.  
  206.  I am working on current problems and will post new versions as they become
  207.  tested.  Currently, distribution is on the Amiga Zone and Aminet ftp sites.
  208.  Obviously,  I will have it on the Amiga Zone first.
  209.  
  210.          The Amiga Zone      (609) 953-8159
  211.  
  212.  Note: other systems will also have the latest version, I am hoping to get
  213.  a system in each state(eventually).  If you wish to have me post a version
  214.  in your area, send me some mail or call the Amiga Zone
  215.  directly.  As always, the Amiga Zone will have it first and a message will
  216.  be posted to the Citadel 68K room when a new version is available.
  217.  
  218.  In this version, you can set the stack to anything larger than 8K
  219.  and Citadel will run.  Anything less and it will stop.  I use a stack of
  220.  30K in my testing because my compiler needs it.  CTDL now does not set
  221.  it's stack, you have to do it.  Citadel does not require more than about
  222.  3K of stack during it's operation.  You can always see what your Citadel
  223.  needs with the SYSOP menu item "I"nformation.  My normal BBS runs use
  224.  the minimum stack of 8192.
  225.  
  226.    It also does not detach from the shell/cli it is started from.
  227.  You have to use "run <nil: >nil: ctdl" to do that.  I leave the window
  228.  open for any error messages.
  229.  
  230.  You can create a short script like:
  231.  
  232.      failat 100
  233.      stack 8000     ; Citadel only uses about 3K in my testing.
  234.      cd cit:
  235.      if not exists ctdltabl.sys
  236.        echo "Citadel configuring, ctdltabl.sys not found"
  237.        confg -O     ; only parameters
  238.      endif
  239.      copy cit:ctdltabl.sys cit:log/ctdltabl.sys
  240.      run ctdl  +netdebug  +netlog
  241.  
  242.  and use it to startup Citadel.  This is similar to my startup
  243.  routine, I also have email networking in my script.
  244.  
  245.  
  246.  Please post a comment in the Citadel 68K room when you start running this
  247.  version.  I would like to have at least your BBS number and general location.
  248.  
  249.  Known Bug List:  8A01
  250.  
  251.  1) report that E hit while a message is paused did not allow the user to
  252.     enter a message(or continue a held message).
  253.  
  254.  2) Fast Transfers does not work with zmodem or any other external protocol.
  255.    You must use the internal protocols.
  256.  
  257.  3) domain mail messages are not being sent to a node that is marked as
  258.     OtherNet (MSGOUT), this affects only those using Internet Email Networking.
  259.  
  260.  You will eventually need utiltites, and probably want Zmodem.  Grab them
  261.  as you need them.  Make sure your read this file and 68K.man BEFORE you
  262.  start, it will save you time and effort.
  263.  
  264.  If you use these files, remember that they are FREEWARE.  You do not have
  265.  to send anyone a donation(although none have been refused) to anyone.  If
  266.  you wish help, find a Citadel with the Citadel 68K room, or call one of
  267.  the BBS numbers above.  This is a project that is solely for the advancement
  268.  of networking and communications.  Enjoy it.  The only restriction I would
  269.  place on you is that you may not make commercial use of this program, sell
  270.  it, or make people pay in anyway for it's use.  If you charge your users
  271.  a small fee for the use of your system, you must contact me and get approval.
  272.  
  273.  Some of the functions are based on shareware programs(like LHA).  These
  274.  programs are not free.  You should send the shareware fee to the author
  275.  for your use with your BBs.
  276.  
  277.  Pay BBS's may use these programs only after they have this approval.  This
  278.  is a copyrighted work.  All rights are reserved by the people responsible
  279.  for maintaining this code.  It belongs solely to them.  If you have
  280.  questions feel free to contact me by posting a message in the Citadel 68K
  281.  room.  If you wish me to send you a set of disks with all the above files,
  282.  I will do so, but it will cost you $10 for the disks, postage, and my time.
  283.  It is free to download from any of the above BBS locations.  It should not
  284.  be more than 3 880K disk.  The Amiga Citadel is available on the mirrored
  285.  ftp site: wuarchive.wustl.edu for those with FTP access.  In
  286.  the future, I will post all the files related to Citadel on those sites.
  287.  
  288.             Tony Preston
  289.             Custom Services
  290.             P. O. Box 254
  291.             Moorestown, NJ 08057
  292.             The Amiga Zone : US (609) 953-8159
  293.             Internet: apreston@k2nesoft.com
  294.  
  295.   The following systems are Citadels and may be used post messages.  This
  296.   List is reasonably current. You best bet is to call the Amiga Zone for the
  297.   latest information.  You will find the Citadel 68K room or Amiga room.
  298.   These systems all net with The Amiga Zone with one or more rooms.
  299.   This list is generated with the vortex detection utility, if your system
  300.   is not listed, post a test seed in a shared room and eventually it will
  301.   appear(Rooms:Amiga, Citadel 68K, or CitaNews).
  302.  
  303.  *NOTE* These are not all the Citadels, there are others which are not on
  304.  the network.  These are active ones, on the network.
  305.  
  306.  Uncensored              203-873-8518  Black Page            212-594-7210
  307.  The Dog Pound           215-946-5573  Data Drum             217-529-8440
  308.  East Beach              313-464-7870  The City Zoo          315-737-9970
  309.  Forgotten Realms        403-450-0618  Ferret-Farm           403-457-3396
  310.  Purgatory               403-462-6976  Flynn's Inn           403-463-8419
  311.  Kronos, Penhold         403-886-4171  Cows r Us             403-990-2239
  312.  The Abbey               407-569-1781  key880                503-524-0670
  313.  Wayne's World           503-557-0786  Mind Melters          503-652-6953
  314.  The CBBS                513-867-1699  HIL-Classic           604-254-4377
  315.  Bistro                  604-542-3617  The Dreamers Guild    604-545-8685
  316.  Northern Exposure       604-558-3897  Mars Hill             604-589-0639
  317.  Underhill               604-589-4752  Nest Glorious         604-589-8539
  318.  Cincidel                606-282-9803  JACS                  609-346-1224
  319.  The OverBored           609-346-9769  Eagle Bored           609-629-1076
  320.  Eagle-Annex             609-767-1775  The Rundale Citadel   609-854-9135
  321.  Gateway                 609-931-3014  Eternal City          612-227-0215
  322.  Ivory Tower             612-425-0554  Backfence             612-429-5001
  323.  Saint's Haven           612-440-8741  DogLink               612-460-6056
  324.  C-86 Test System        612-470-9635  Knight Life           612-544-6978
  325.  Stomp                   612-561-4643  Cobalt Blue           612-642-0082
  326.  Nowhere                 612-645-3998  Hills                 612-673-0676
  327.  Metropolis              612-721-1870  NO NAME NODE          612-758-8201
  328.  Dark Tower ][           612-770-0150  Dark Tower ][         612-773-1267
  329.  Interzone               612-773-6666  MN-Mensa              612-774-7593
  330.  The HUB                 612-783-7160  Writer's Cramp        612-789-1159
  331.  The Last Rose           612-823-3280  Rock the Boat         612-827-4291
  332.  House of Moo            612-831-2312  Cheers                612-854-2126
  333.  Last Call               612-861-7094  Spielen Schloss       612-869-4927
  334.  Hell                    612-870-0722  Images at Twilight    612-884-7951
  335.  the Unseelie Court      612-938-6761  GWNorth               612-939-8142
  336.  A Strange Place         612-939-9008  Elk!                  612-944-3622
  337.  Black Hole              616-343-7487  Au Contraire          616-344-5599
  338.  Lair                    616-344-6607  Broadcast Central     616-345-9374
  339.  Beach                   616-349-5887  Paradise Lost         902-429-5412
  340.  CatBBS                  902-434-3295  Omnibus/BL 435-0237   902-435-0237
  341.  Rivendell               902-463-1988  Duffy's               902-466-8802
  342.  Mirror Image            902-835-3056  Rendezvous            902-876-1208
  343.  ENY                     914-735-9362  Hotel                 916-349-8879
  344.  SHAMAN'S VENTURE        916-364-1868  MEDIA-DEKAY           916-448-1197
  345.